home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / Xm / XmStringToXmStringTable.z / XmStringToXmStringTable
Encoding:
Text File  |  2001-04-17  |  4.8 KB  |  67 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTooooXXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVXXXXmmmmSSSSttttrrrriiiinnnnggggTTTTooooXXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTooooXXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee - A convenience function that
  10.           converts a single compound string to a table of compound
  11.           strings
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.           #include <Xm/Xm.h>
  15.           CCCCaaaarrrrddddiiiinnnnaaaallll XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTooooXXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee(
  16.           XXXXmmmmSSSSttttrrrriiiinnnngggg ssssttttrrrriiiinnnngggg,
  17.           XXXXmmmmSSSSttttrrrriiiinnnngggg bbbbrrrreeeeaaaakkkk____ccccoooommmmppppoooonnnneeeennnntttt,
  18.           XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee ****ttttaaaabbbblllleeee);
  19.  
  20.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  21.           This page documents Motif 2.1.
  22.  
  23.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.           XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTooooXXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee takes as input a single compound
  25.           string and a specified string component (such as a tab) and
  26.           returns a table of compound strings consisting of portions
  27.           of _s_t_r_i_n_g delimited by components matching _b_r_e_a_k__c_o_m_p_o_n_e_n_t.
  28.           The components marking breaks will not appear in the
  29.           resulting table.
  30.  
  31.           _s_t_r_i_n_g    Specifies the XXXXmmmmSSSSttttrrrriiiinnnngggg to be converted.
  32.  
  33.           _b_r_e_a_k__c_o_m_p_o_n_e_n_t
  34.                     Specifies the _X_m_S_t_r_i_n_g_C_o_m_p_o_n_e_n_t that will be used
  35.                     to indicate where to split _s_t_r_i_n_g to form the
  36.                     individual elements of _t_a_b_l_e. The most useful
  37.                     types will be XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____SSSSEEEEPPPPAAAARRRRAAAATTTTOOOORRRR and
  38.                     XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____TTTTAAAABBBB. Refer to the
  39.                     XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooommmmppppoooonnnneeeennnnttttTTTTyyyyppppeeee(3) reference page for a
  40.                     complete list of possible component types. Note,
  41.                     however, that the XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____UUUUNNNNKKKKNNNNOOOOWWWWNNNN
  42.                     component is not a possible type.
  43.  
  44.           _t_a_b_l_e     Returns the equivalent XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee.  The
  45.                     function will allocate space to hold the returned
  46.                     XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee.  When the applicaiton no longer
  47.                     needs the returned XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee, the application
  48.                     should call XXXXmmmmSSSSttttrrrriiiinnnnggggFFFFrrrreeeeeeeeonce for each compound
  49.                     string in the table, and then calling XXXXttttFFFFrrrreeeeeeee to
  50.                     deallocate the XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee itself.
  51.  
  52.      RRRREEEETTTTUUUURRRRNNNN
  53.           Returns the number of compound strings in _t_a_b_l_e.
  54.  
  55.      RRRREEEELLLLAAAATTTTEEEEDDDD
  56.           XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee(3).
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 4/6/01)
  64.  
  65.  
  66.  
  67.